Configuring Dashboard Settings

On the Settings page, dashboard owners and Organization Administrators can configure general dashboard settings, add or modify dashboard variables, and edit the JSON Model of the dashboard.

To access dashboard settings: 

  1. Navigate to Dashboard > Library.

  2. Locate and click the dashboard whose settings you want to configure.

  3. Click Edit > Dashboard Settings ().

Configuring General Settings

On the General Settings tab, you can configure key dashboard details such as its name, description, tags, and ownership, as well as define access permissions and role-based visibility. You can also customize how the dashboard behaves by enabling features like tag filtering, optimized load, content view, and auto-refresh intervals. In addition, users can control time-related settings, including global and panel-level time pickers and delay options for more accurate data display.

To configure general dashboard settings:

  1. Click Edit > Dashboard Settings () on the dashboard.
    The General Settings page opens.

  2. Configure the following parameters:

    Setting Description
    Name Name of the dashboard.
    Description

    A brief summary of what the dashboard shows and how it is used.

    Tags

    Tags applied to the dashboard.

    If you want to create a new tag, enter a tag name (up to 50 characters), select a tag color, and then click +. The new tag appears in the Tags section. It is also added to the list of the Resource Tags. See Resource Tags for more information.
    Show Tag Filter When enabled, displays the tag filter component on the dashboard page to allow filtering panels by tags.
    Optimized Dashboard Load When enabled, speeds up the dashboard load time by rendering the dashboard immediately with placeholder or default values. Variable values are fetched asynchronously in the background.
    Enable Content View When enabled, hides navigation elements such as the Folder Breadcrumb, title, favorite button, edit button, refresh button, and clone buttons.
    Owner Owner of the dashboard. To learn more about the owner's permissions, refer to Managing Custom Dashboard Permissions.
    Permission

    Whether the dashboard is private or shared.
    Roles Access

    Displays which user roles can access the dashboards and what permissions they have. For more details on dashboard permissions, refer to Managing Custom Dashboard Permissions.

    Note: To learn more about user roles, refer to Managing Roles.
    Auto Refresh Defines the auto refresh intervals that should be available in the auto refresh drop-down list.
    Now delay now

    1m value ignores the last minute because it can contain incomplete metrics.
    Hide global time picker When enabled, hides the global time picker.
    Enable time picker for each panel When enabled, hides the global time picker for each dashboard panel.

  3. Click Save Dashboard to save the dashboard changes.
    Click Save As to create a new dashboard based on the configured dashboard. You can modify the dashboard name and copy tags, if necessary.

  4. Reload the changes for the dashboard to take effect.

Adding Dashboard Variables

Variables enable more interactive and dynamic dashboards. Instead of hard-coding things like server or sensor names in your metric queries, you can use variables in their place. Variables are displayed at the top of the dashboard, making it easy to change the data displayed on your dashboard.

To add a dashboard variable:

  1. Click Edit > Dashboard Settings () on the dashboard.

  2. Click the Variables tab.

  3. Click Add variable.

  4. Configure the variable settings.

    5. Note: By default, the dashboard dropdown displays 100 results. You can increase this limit up to 5,000, but you may encounter longer loading times and overall slower performance.

  5. Click Update.

  6. Click Save Dashboard.

The new variable appears at the top of the dashboard.

All created variables can also be found on the Variables tab of the dashboard Settings page.

On the Variables tab, you can apply the following actions to the variables you created:

  • Configure variable settings by clicking on the variable of interest

  • View variable usage by hovering your mouse over the merged branch () icon

  • Re-arrange the order in which the variables are displayed on the dashboard by using the up () and down () arrows.

  • Duplicate variables by clicking the duplicate () icon.

  • Delete variables by clicking the delete () icon.

  • Create a new variable by clicking New.

Configuring JSON Model

To configure the dashboard JSON Model:

  1. Click Edit > Dashboard Settings () on the dashboard.

  2. Click the < > JSON Model tab.

  3. Make the required changes in the objects, and click Save Changes.

After configuring the dashboard JSON Model, click Save Dashboard to save the changes.

Click Save As if you want to create a new dashboard based on the configured JSON Model. You can modify the dashboard name and copy tags, if necessary.

Configuring Variable and Panel Dependencies

On the < > JSON Model tab of the Settings page, you can configure variable and panel dependencies. For example, you can define which Sweep Type options to display if Sweep Selector is set to Sweep Select.

Variables can also help you improve dashboard data visibility by allowing you to show or hide panels based on variable options specified in panel dependencies.

To configure variable dependencies:

  1. Click Edit > Dashboard Settings () on the dashboard.

  2. Click the < > JSON Model tab.

  3. In the templating object of the dashboard JSON Model, add the depends property to the variable definition to configure dependencies.

  4. Configure dependencies of all variables.

  5. Click Save Changes.

To show/hide a panel:

  1. Click Edit > Dashboard Settings () on the dashboard.

  2. Click the < > JSON Model tab.

  3. In the panels object of the dashboard JSON Model, locate the panel whose visibility you want to configure.

  4. In the depends property, list all variable options that, if selected, will make the panel visible.
    For example, the image below demonstrates that the Panel Title panel is visible only when the radio_type variable is set to email or url. This means that when other variable options are selected, the panel will be hidden on the dashboard.

    If dependencies are not specified, the panel will always be visible.

  5. Click Save Changes.